home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / bpq408.zip / APPLS.DOC < prev    next >
Text File  |  1992-02-09  |  3KB  |  77 lines
  1.         Application Support for G8BPQ Switch
  2.  
  3.  
  4. Until now, the switch has supported connects to two sets of application
  5. programs. The first is the BBS, obtained by connecting to the BBS call/alias,
  6. or connecting to the switch end entering BBS. The second is the SYSOP,
  7. obtained by entering the 'C' command without a callsign from the switch. The
  8. commands CONOK ON or HOSTOK ON had to be sent by the program, to indicate 
  9. that the TNC port was available. From Version 3.20, up to 8 applications 
  10. are supported. The first two are as above, the third is reserved for remote 
  11. SYSOP access, and the other 5 are available for your own applications. The
  12. list of application names is given in the APPLICATIONS= param in the config
  13. file, and is a string of up to 8 names of up to 12 chars each, separated by
  14. commas. The names will be listed to the user, along with the normal commands
  15. in the 'available commands' prompt, obtained by entering ?. The user enters
  16. the Application name to connect to it, in the same way as he can enter BBS to
  17. connect to the BBS. Note that, for the moment at least, these additional
  18. applications do not have there own callsign/alias, so must be accessed via 
  19. the switch. (but you could rename the first application if you really want
  20. to!).
  21.  
  22.  
  23. It is possible to configure the port so that the user's command line is passed
  24. to the application. You can also specify whether the user should receive
  25. a '*** Connected to APPL' message, and whether the Application gets a
  26. '*** CONNECTED to USER' message. The TNCPORTS are defined by sets of params
  27. in the following format:
  28.  
  29.  
  30. TNCPORT
  31.     COM=n        ; COMBIOS port number
  32.     TYPE=TNC2    ; From version 4.00 this is the only type supported
  33.     APPLMASK=nn    ; Defaults to 1 (BBS)
  34.     APPLFLAGS=nn    ; Defaults to 6
  35. ENDPORT
  36. ;
  37.  
  38. APPLMASK is used in the same way as the APPL TNC command described
  39. below. The value is in decimal.
  40.  
  41. APPLFLAGS control whether the user's command is passed to the application,
  42. and also whether 'CONNECTED' messages are sent in each direction. Values
  43. are:
  44.     1 - Send Command to application.
  45.     2 - Send 'Connected' to user.
  46.     4 - Send 'Connected' to application.
  47.  
  48. Values may be combined as required - the default is 6, which gives the
  49. same result as the older versions.
  50.  
  51. There is also an equivalent APPLFLAG command available at TNC2 command level.
  52.  
  53.  
  54.  
  55. When using TNC2 mode, the program should send two commands to the virtual
  56. TNC:-
  57.  
  58.     APPL $NN
  59.  
  60. Where NN has a bit set corresponding to the appl. number. eg $01 for BBS,
  61. $08 for 4th appl. More than one can be set, allowing the port to support 
  62. more than one application. This may be appropriate if the command line is
  63. sent to the application, so it can work out what the user wants.
  64. Note the the default is $01, so existing BBS applications will still work.
  65.  
  66.  
  67.     CONOK ON
  68.  
  69. To indicate port is ready to accept connects.
  70.  
  71. There is a trivial sample application program, SAMPLE.C  on the disk.
  72.  
  73.  
  74. From version 4.00 onwards, a new application interface is provided. See file
  75. BPQHOST.DOC for further details.
  76.  
  77.